home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / phandler.z / phandler
Encoding:
Text File  |  2001-04-17  |  8.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4. PPPPHHHHAAAANNNNDDDDLLLLEEEERRRR((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       PPPPHHHHAAAANNNNDDDDLLLLEEEERRRR((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      phandler - generic parallel printer driver
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _p_h_a_n_d_l_e_r ----PPPP pppprrrriiiinnnntttteeeerrrrnnnnaaaammmmeeee [ options ] [ inputfile ]
  13.  
  14.             Where [ options ] consist of one or more of:
  15.                      [ ----eeee ]
  16.                      [ ----ssss ]
  17.                      [ ----wwww ]
  18.                      [ ----DDDD ]
  19.                      [ ----LLLL logfilename ]
  20.                      [ ----RRRR ]
  21.                      [ ----BBBB buffersize ]
  22.                      [ ----IIII ]
  23.                      [ ----uuuu ]
  24.                      [ ----SSSS papersize ]
  25.                      [ ----dddd ]
  26.                      [ ----KKKK ]
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      The _p_h_a_n_d_l_e_r driver is a generic driver for printers attached to the
  30.      built-in (/dev/plp*) parallel port. _p_h_a_n_d_l_e_r uses _l_i_b_p_o_d(_3) functions to
  31.      keep the printer object database (POD) current, provide feedback on any
  32.      engine errors encountered, and to serve as an example program for
  33.      developers.  The source for phandler is part of the _I_m_p_r_e_s_s_a_r_i_o
  34.      _D_e_v_e_l_o_p_e_r'_s _K_i_t.
  35.  
  36.  
  37.      The driver opens and maintains the POD files for the specified printer.
  38.      The file <_p_r_i_n_t_e_r_n_a_m_e>._c_o_n_f_i_g contains the detailed information on the
  39.      printer's capabilities, <_p_r_i_n_t_e_r_n_a_m_e>._s_t_a_t_u_s contains the information on
  40.      operational status of the printer, and <_p_r_i_n_t_e_r_n_a_m_e>._l_o_g contains the
  41.      information on print job history.  For more information on printer
  42.      database files refer to the _l_i_b_p_o_d(_3) man page.
  43.  
  44.  
  45.      While _p_h_a_n_d_l_e_r has the port open, it performs an advisory file lock on
  46.      the parallel port, thereby ensuring that only one _p_h_a_n_d_l_e_r accesses the
  47.      printer at a time.
  48.  
  49.  
  50.      _p_h_a_n_d_l_e_r also creates a child process  to update the POD printer status
  51.      database.  This child is killed automatically upon the parent's death.
  52.  
  53.  
  54. UUUUSSSSAAAAGGGGEEEE
  55.      _p_h_a_n_d_l_e_r assumes that its input is coming from standard input
  56.                (stdin) unless a filename is specified after any and all
  57.                command line options.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPHHHHAAAANNNNDDDDLLLLEEEERRRR((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       PPPPHHHHAAAANNNNDDDDLLLLEEEERRRR((((1111))))
  71.  
  72.  
  73.  
  74.      ----PPPP _p_r_i_n_t_e_r_n_a_m_e
  75.                specifies the printer with which _p_h_a_n_d_l_e_r is communicating.
  76.                _p_r_i_n_t_e_r_n_a_m_e is the name under which the System VR3 spooler
  77.                recognizes the printer, as given on the _l_p(_1) command line.
  78.                This option is required.
  79.  
  80.  
  81.      ----eeee        specifies that driver should exit immediately on fault.   By
  82.                default, the driver waits indefinitely for faults to clear,
  83.                retrying any errors every several seconds, where the exact
  84.                number of seconds is defined in the POD config database entry
  85.                _e_r_r_o_r__r_e_t_r_y__w_a_i_t.
  86.  
  87.  
  88.      ----ssss        specifies that the driver should exit after ascertaining
  89.                printer status and updating the POD status file.  If an error
  90.                is encountered, however, _p_h_a_n_d_l_e_r will block unless the ----eeee
  91.                switch is given as well. If a quick status update is what you
  92.                want, invoke _p_h_a_n_d_l_e_r with both the ----ssss and the ----eeee options to
  93.                insure that _p_h_a_n_d_l_e_r exits promptly.
  94.  
  95.  
  96.      ----wwww        Specify this flag to suppress warning messages in the printer
  97.                status file. By default, warning messages such as "low on ink"
  98.                or other non-fatal errors are written to the printer status
  99.                file.
  100.  
  101.  
  102.      ----DDDD        Turns on debugging information.  Four levels of debugging
  103.                information are supported: none, coarse detail, medium detail,
  104.                and fine detail.  These correspond to 0, 1, 2, and 3 or more ----DDDD
  105.                switches given on the command line.  That is, multiple -D
  106.                options given on the command line result in progressively more
  107.                detailed debugging information.
  108.  
  109.  
  110.      ----LLLL _l_o_g_f_i_l_e_n_a_m_e
  111.                specifies a filename to which error and debug information
  112.                should be appended.  If this option is not specified, error and
  113.                debug information is appended to _p_h_a_n_d_l_e_r'_s standard error
  114.                (stderr), which is generally redirected by the System VR3
  115.                spooler to /_v_a_r/_s_p_o_o_l/_l_p/_l_o_g.
  116.  
  117.  
  118.      ----RRRR        specifies that the parallel port should be reset immediately
  119.                after opening it.  This may have detrimental effects on some
  120.                printers, which may go offline for extended periods of time,
  121.                and therefore the ----RRRR option should be used with care.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPHHHHAAAANNNNDDDDLLLLEEEERRRR((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       PPPPHHHHAAAANNNNDDDDLLLLEEEERRRR((((1111))))
  137.  
  138.  
  139.  
  140.      ----BBBB _b_u_f_f_e_r_s_i_z_e
  141.                specifies a positive number of bytes to buffer on each read and
  142.                write.  Setting the _b_u_f_f_e_r_s_i_z_e to 1 (one) results in single-
  143.                byte reads and writes, which can be very inefficient.  It is
  144.                recommended that if this option is specified, the _b_u_f_f_e_r_s_i_z_e be
  145.                an integral multiple of the system block size.
  146.  
  147.  
  148.      ----IIII        if specified enables sensing of EOI pin on the parallel port
  149.                (which is normally ignored).
  150.  
  151.  
  152.      ----uuuu        if specified the parallel port status is ignored.  Only valid
  153.                when ----ssss is specified.
  154.  
  155.  
  156.      ----SSSS _p_a_p_e_r_s_i_z_e
  157.                if specified the POD database will be updated with the paper
  158.                size.  Valid paper sizes are listed in /usr/include/pod.h.
  159.  
  160.  
  161.      ----dddd        if specified, the driver will send a Control-D character at end
  162.                of job.  Some printers use this to determine that the end of
  163.                the input stream has been reached.
  164.  
  165.  
  166.      ----KKKK        Ignore Interrupts.  If specified, phandler will ignore
  167.                interrupts and will continue to send output to the parallel
  168.                port until end-of-file is encountered on standard input.  If
  169.                _p_h_a_n_d_l_e_r receives a job cancellation (SIGTERM) signal it will
  170.                continue to read the input until end of file is reached and
  171.                will discard the input (it will not be sent to the printer).
  172.                This means that if a printer is unable to accept data,
  173.                cancelling the job may not kill the _p_h_a_n_d_l_e_r process
  174.                immediately.  To do so, you must explicitly kill the process
  175.                with SIGKILL (9), or reboot the machine.  If a problem is
  176.                detected on the parallel port then phandler will continue to
  177.                run until the problem clears (this prevents subsequent print
  178.                jobs from being sent to the parallel port until the problem is
  179.                cleared).
  180.  
  181.  
  182. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  183.      lp(1), lpadmin(1), libpod(3), libspool(3), printstatus(1), printpanel(1).
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.